home *** CD-ROM | disk | FTP | other *** search
/ Asim CDFS 3.0 / Asim CDFS.adf / AudioLibrary_Conv.ReadMe < prev    next >
Text File  |  1996-02-01  |  4KB  |  83 lines
  1. AudioLibrary_Converter 1.0  --  August 24th, 1995
  2. -------------------------------------------------
  3.  
  4. Note:  Please take a few moments and read this document. 
  5.  
  6.  
  7. Brief ramblings...
  8. ------------------
  9. In AsimCDFS v2, librarian functions were added to the AsimTunes audio
  10. playback commodity.  The user was allowed to construct a library
  11. of the audio discs that were inserted into the system.  Additionally,
  12. the user was able to enter in proper names for the disc, author, and
  13. individual track titles.  This system worked quite well (so well, in
  14. fact, that we had a large number of users who entered in hundreds
  15. of discs into their person libraries).  Unfortunately, we needed
  16. a more flexible library format for AsimCDFS v3.
  17.  
  18. Our concept of a good library file for AsimCDFS v3, again unfortunately,
  19. was not compatible with the existing v2.x format.
  20.  
  21. The AudioLibrary_Converter program is a conversion utility allowing
  22. you to convert from the AsimCDFS v2.x audio file (called AudioLibrary.data)
  23. to the AsimCDFS v3.x library (divided into two parts, CD_Library.data
  24. and CD_Library.index).
  25.  
  26.  
  27.  
  28. Converting your library
  29. -----------------------
  30. The process of converting your AsimCDFS v2.x library to the AsimCDFS v3.x
  31. library is a very simple three-step process.  In brief, you must:
  32.       · run the AudioLibrary_Converter program;
  33.       · load in your old AudioLibrary.data file;
  34.       · save out the new library.
  35.  
  36. The program can be run from either the CLI or Workbench.  In either
  37. case, there are no arguments.  You will be presented with a large
  38. window with three gadgets at the bottom and a display area in the middle.
  39.  
  40. Select the "Load Old" gadget (the middle one).  This will bring up a 
  41. file requestor allowing you to specify where your old AudioLibrary.data
  42. file exists.  >>Unless you have manually deleted it<<, the file will
  43. be in your AsimCDFS: directory (which was formally your AsimTunes:
  44. directory).  Alternatively, if you have a back-up of this file, you can
  45. specify its location.  Click on "Ok" to load in the library.
  46.  
  47. AudioLibrary_Converter will then proceed to load in all the entries
  48. from the old audio library.  These will be displayed in the middle 
  49. portion of the screen.  The list of audio discs is scrollable for
  50. your perusing pleasure, but read-only.
  51.  
  52. The final step is to save the audio discs into the AsimCDFS v3.x
  53. library.  This is done with the "Save Library" gadget.  If AsimCDFS
  54. detects an identical disc already in your library, it will bring
  55. up a requestor informing you of this.  Thus, if you have any
  56. entries in your current AsimCDFS v3.x library that you want replaced
  57. (ie.  you have not typed in track titles, etc.) then you must
  58. go to AsimTunes and delete the offending entires via the Edit Library
  59. function.  (*** Hint:  clear out the offending entries in current audio
  60. library before you run this AudioLibrary_Converter program! ***)
  61.  
  62. That is it.  Your AsimCDFS v3.x should now contain your old
  63. audio library appended to the current entries in your library.
  64.  
  65.  
  66.  
  67. Notes
  68. -----
  69. Yes, we have shortened the length available for track and disc
  70. titles.  This was a deliberate action due to the fact that
  71. these names are now used as file names.  This leaves a limit of
  72. 26 characters for the track names (this restriction results from
  73. the fact that a .info extension must be appended to each file
  74. name to create the associated icon file).
  75.  
  76. All names in the v2.x audio library will be truncated to fit
  77. into the new restrictions.
  78.  
  79.  
  80. Please note that this program should be part of the AsimCDFS v3.3
  81. package (or greater).  It will not function with AsimCDFS v3.2,
  82. v3.1 or v3.0.
  83.